package com.kexio.user.service;

import java.util.List;
import java.util.Map;

/**
 * 安全监控服务接口
 *
 * 🛡️ 职责：
 * - 提供IP访问统计和分析
 * - 权限访问模式分析
 * - 安全威胁检测和建议
 * - 安全事件趋势分析
 *
 * @author Kexio Team
 * @since 2.2.0
 */
public interface SecurityMonitorService {

    /**
     * 获取IP访问统计
     * @param hours 统计时间范围（小时）
     * @return IP访问统计列表
     */
    List<Map<String, Object>> getIpStatistics(int hours);

    /**
     * 获取权限访问统计
     * @param hours 统计时间范围（小时）
     * @return 权限访问统计数据
     */
    Map<String, Object> getPermissionStatistics(int hours);

    /**
     * 获取安全建议
     * @return 安全改进建议列表
     */
    List<Map<String, Object>> getSecurityRecommendations();

    /**
     * 获取安全事件分析
     * @param days 分析天数
     * @return 安全事件分析数据
     */
    Map<String, Object> getSecurityEventsAnalysis(int days);

    /**
     * 获取安全趋势数据
     * @param days 趋势分析天数
     * @return 安全趋势数据
     */
    Map<String, Object> getSecurityTrends(int days);
}
